home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #14 / Monster Media No. 14 (April 1996) (Monster Media, Inc.).ISO / utils / fstmp105.zip / FSTAMP.DOC < prev    next >
Text File  |  1996-01-19  |  7KB  |  153 lines
  1.                                 F S T A M P
  2.  
  3.                               File Stamp v1.05
  4.                      Copyright (c) 1996 Robert B. Clark
  5.                             All rights reserved.
  6.                    ─────────────────────────────────────
  7.  
  8. DISCLAIMER OF WARRANTY:
  9. ───────────────────────
  10.  
  11. This software program and documentation ("FSTAMP") is being offered for
  12. evaluation purposes "as is" and without warranties as to performance or
  13. merchantability.  By using FSTAMP, you are expressly releasing Robert B.
  14. Clark from any liability resulting from the use of this software and
  15. documentation. The user must assume the entire risk of using FSTAMP. Because
  16. of the diversity of conditions, hardware and operating environments under
  17. which FSTAMP may be used, no warranty of fitness for a particular purpose is
  18. offered.  The user is advised to test and supervise FSTAMP thoroughly before
  19. relying upon it.
  20.  
  21.  
  22. LICENSE:
  23. ────────
  24.  
  25. FSTAMP is FREEWARE and you are encouraged to freely distribute it via
  26. electronic or magnetic media as long as the author's original attributions
  27. and copyright notice remain intact.  No charge may be levied for this
  28. program other than a nominal fee for BBS access or for media costs.
  29.  
  30. ┌───────────╖
  31. │ MANIFEST: ║
  32. └───────────╝
  33.  
  34.    If your package doesn't contain these files, complain to someone:
  35.  
  36.    FILE_ID.DIZ  Description for use with the more enlightened BBSes.
  37.    FSTAMP.DOC   This file.  Installation and usage instructions.
  38.    FSTAMP.EXE   The FSTAMP program executable.
  39.  
  40.  
  41.    McAfee Validate v2.0.1:
  42.    ───────────────────────
  43.    FSTAMP    EXE     18530  01-19-96   1:05a   23C7   D6B1
  44.  
  45. ┌────────╖
  46. │ USAGE: ║
  47. └────────╝
  48.  
  49.    Extract the FSTAMP105 archive into a directory listed in your PATH.
  50.  
  51.    Type "FSTAMP /?" to view the help screen:
  52.  
  53.  ┌───────────────────────────────────────────────────────────────────────────┐
  54.  │ File Stamp stamps a file with a specified date and/or time.               │
  55.  │                                                                           │
  56.  │ FSTAMP filespec [date][time]                                              │
  57.  │                                                                           │
  58.  │   filespec      File name(s) to stamp.  Wildcards are acceptable.         │
  59.  │   date          Use the form DD.MM.YY.                                    │
  60.  │   time          Use the form HH:MM:SS.                                    │
  61.  │                                                                           │
  62.  │ Omitted fields of the date and time default from the system date and time.│
  63.  │ The date and time arguments are interchangeable.                          │
  64.  │                                                                           │
  65.  │ FSTAMP v1.05 Copyright(c) 1996 Robert B. Clark <rclark@iquest.net>.       │
  66.  │ All rights reserved.  This program is freeware.                           │
  67.  └───────────────────────────────────────────────────────────────────────────┘
  68.  
  69.    The 'filespec' argument is required.  If the file or files specified by
  70.    'filespec' are not found, FSTAMP terminates with errorlevel 255.
  71.  
  72.    FSTAMP can change the date and time of any normal, system, hidden or
  73.    read-only file as long as the file may be opened in shared, read access.
  74.    The attribute bit will be updated when the file is stamped.
  75.  
  76.    FSTAMP does not work on disk volume labels or directories.
  77.  
  78.    The 'date' and 'time' arguments specify the date with which the files
  79.    will be stamped.  Any missing fields in the date and time arguments
  80.    default from the current system date and time.
  81.  
  82.    For example, if the current date were 22 July 1995 at 17:00:12,
  83.  
  84.        fstamp //98         would mean   fstamp 07/22/1998 17:00:12
  85.        fstamp /5 1:00p     would mean   fstamp 07/05/1995 13:00:12 and
  86.        fstamp 10 13        would mean   fstamp 10/22/1995 13:00:12
  87.  
  88.    The format of date and time is dependent upon the country detected at
  89.    runtime (see COUNTRY in your DOS manual).  If your computer is set up to
  90.    use the German language support for DOS (country code 049), the program
  91.    expects the date to be in "DD.MM.YY" format and will parse the date you
  92.    enter accordingly.
  93.  
  94.    Incidentally, the help screen always displays the correct date and time
  95.    conventions for the current country.  As a matter of fact, the help
  96.    screen in this document was grabbed while the author was using the German
  97.    code page.
  98.  
  99.    If the 'date' argument contains a colon (:), FSTAMP assumes that the
  100.    argument is meant to be a time instead of a date and will obligingly
  101.    switch the 'date' and 'time' arguments for you.  Thus,
  102.  
  103.           fstamp 10:15 8/30
  104.  
  105.   will be parsed as 30 Aug 10:15 instead of 15 Oct 08:30.
  106.  
  107. ┌───────────╖
  108. │ EXAMPLES: ║
  109. └───────────╜
  110.  
  111.    Revision Control
  112.    ────────────────
  113.    To set all of the *.DOC files in the C:\WP51\WORK directory to to the
  114.    time 01:10:04 a.m. (perhaps to indicate Rev 1.10b of a proposal):
  115.  
  116.                  C:\>FSTAMP c:\wp51\work\*.doc 1:10:04
  117.  
  118.    Note that the date was omitted--FSTAMP will use the current date.
  119.  
  120.    Illegal Date/Time
  121.    ─────────────────
  122.    You can take this revision marking thing a little further and say
  123.  
  124.                 C:\>FSTAMP *.CPP 1:63:0
  125.  
  126.    which stamps all of the *.CPP files in the current directory with the
  127.    "illegal" time of 01:63:00 a.m. (aka 2:04 a.m.).
  128.  
  129.    While we're on the subject, here are the permissable limits for date and
  130.    time in the world of DOS:
  131.  
  132.  
  133.             The date limits:                  The time limits:
  134.    ┌────────────────────────────────╥────────────────────────────────┐
  135.    │ Day   = mod 32        (0..31)  ║     Hour     = mod 32  (0..31) │
  136.    │ Month = mod 16        (0..15)  ║     Minute   = mod 64  (0..63) │
  137.    │ Year  = mod 128  (1980..2107)  ║     Seconds  = mod 63  (0..62) │
  138.    └────────────────────────────────╨────────────────────────────────┘
  139.  
  140.    While you can have fun dating your files 00/00/00 (00/00/2000), you may
  141.    want to be aware that many programs go insane (or at least slightly
  142.    schizophrenic) when encountering odd dates and times--that includes DOS.
  143.  
  144.    For a really good time, try dating a file 00/00/1980.
  145.  
  146.  
  147.   That's all there is to it.  Enjoy!
  148. ─────────────────────────────────────────────────────────────────────────────
  149. The author may be contacted at:
  150.  
  151. E-Mail:   rclark@iquest.net
  152. RelayNET: Shareware or Common conferences r/ro to ROBERT CLARK at ->5
  153.